home *** CD-ROM | disk | FTP | other *** search
/ The PC-SIG Library 9 / The PC-SIG Library on CD ROM - Ninth Edition.iso / 801_900 / DISK0843 / DISK0843.ZIP / OMEGA.ARC / OMEGAEXT.DOC < prev    next >
Text File  |  1988-11-23  |  10KB  |  231 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.      The Omega-Link External protocol handler comes to you preconfigured
  8.      for several popular external protocols.  If you wish to add other
  9.      protocols or modify the existing ones, see the section on installing
  10.      protocols.
  11.  
  12.  
  13.      INSTALLING THE EXTERNAL PROTOCOL HANDLER
  14.  
  15.      You will need to make the files OMEGAEXT.EXE and OMEGAEXT.DAT
  16.      available to Omega-Link.  To do this you must copy them into either
  17.      the current directory or a directory that is listed in the DOS PATH
  18.      command.  The file OMEGAEXT.EXE will usally be placed in the same
  19.      directory as OMEGA.EXE, and OMEGAEXT.DAT will be placed in the
  20.      download sub-directory.
  21.  
  22.      The external protocol files will also need to be located so that the
  23.      external protocol handler can find them.  This will usally be in the
  24.      same directory as OMEGAEXT.EXE.  You may also edit the protocol
  25.      descriptions to tell the external protocol handler where to find the
  26.      external protocols if they won't be current directory.  A description
  27.      of this process appears in the section on installing additional
  28.      protocols.
  29.  
  30.      Recommended configurations
  31.  
  32.      If you have only one floppy diskette drive and no harddisk drive.
  33.      -----------------------------------------------------------------
  34.  
  35.      PATH=
  36.      COMSPEC=\COMMAND.COM
  37.  
  38.      Program disk                     Data disk
  39.      ------------                     ---------
  40.      OMEGA.EXE                        External protocols (.EXE and .COM)
  41.      OMEGADIR.DAT                     downloaded files
  42.      OMEGADEF.DAT
  43.      OMEGAFUN.DAT
  44.      OMEGAALT.DAT
  45.      OMEGAEXT.EXE
  46.      OMEGAEXT.DAT
  47.      COMMAND.COM
  48.  
  49.      When the external protocol handler asks for the protocol to use
  50.      remove the program disk and insert the data disk.  As soon as the
  51.      download or upload is completed reinsert the program disk.  Please
  52.      note that due to the small amount of disk space that Omega-Link
  53.      requires, it may be possible to have everything on one disk and still
  54.      have quite a bit of space for downloads.  This is especially true of
  55.      3-1/2" 720k or 1.44 meg floppy diskette systems.  For this type of
  56.      system you may wish to simply copy all of the files onto program
  57.      diskette.
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.      For Two floppy diskette systems.
  65.      --------------------------------
  66.      PATH=B:\
  67.      COMSPEC=A:\COMMAND.COM
  68.  
  69.      DISKETTE IN DRIVE A:               DISKETTE IN DRIVE B:
  70.      --------------------               --------------------
  71.      COMMAND.COM                        OMEGAEXT.DAT
  72.      OMEGA.EXE                          downloaded files
  73.      OMEGAEXT.EXE
  74.      OMEGADIR.DAT
  75.      OMEGAFUN.DAT
  76.      OMEGAALT.DAT
  77.      OMEGADEF.DAT
  78.      External protocols
  79.  
  80.      This configuration will give you the largest amount of space for
  81.      downloaded files, however, it does require you to copy the file
  82.      OMEGAEXT.DAT to each new diskette that you wish to use for downloads
  83.      or uploads.  Therefore, you may wish to copy all the files onto you
  84.      program diskette and then modify OMEGAEXT.DAT to use drive B:.
  85.  
  86.      For Harddisk systems.
  87.      ---------------------
  88.      PATH=C:\;C:\OMEGA;C:\FILES
  89.      COMSPEC=C:\COMMAND.COM   (or whatever is needed to find command.com)
  90.  
  91.      Directory C:\OMEGA                 Directory C:\FILES
  92.      ------------------                 ------------------
  93.      OMEGA.EXE                          OMEGAEXT.DAT
  94.      OMEGAEXT.EXE                       downloaded files
  95.      OMEGADIR.DAT
  96.      OMEGADEF.DAT
  97.      OMEGAFUN.DAT
  98.      OMEGAALT.DAT
  99.      External protocols
  100.  
  101.      ---------------------------------------------------------------------
  102.      The following protocols have been preconfigured into the external
  103.      protocol handler: DSZ (Zmodem, Ymodem-batch, and Ymodem-G), MLINK16
  104.      (Megalink), PCKERMIT (Kermit), and CISB (Compuserve "B").  Our thanks
  105.      go to the authors of these programs. Most of these programs may be
  106.      downloaded from almost any BBS that has MS-DOS files.  We have not
  107.      included any of these files to prevent violating there copyrights and
  108.      to prevent you from having to download the same file twice.
  109.      ---------------------------------------------------------------------
  110.  
  111.      INSTALLING ADDITIONAL PROTOCOLS
  112.      -------------------------------
  113.      To install a new protocol first copy the protocol into the directory
  114.      that you wish use.  Then type OMEGAEXT at the DOS prompt.
  115.  
  116.      A menu will be displayed with the currently defined protocols and
  117.      several entries marked "(Not defined)".  Select one the the not
  118.      defined entries by pressing the letter that procedes it.
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.      At this time a menu will appear.  You may use the up and down arrow
  126.      keys to move from item to item.  First select the very top item and
  127.      press <F1>, this will erase the "(Not defined) message.  Now you may
  128.      type the name that you wish to assign to this protocol.
  129.  
  130.      Next move down one line and press "N".  If you know that this
  131.      protocol restores the machine to EXACTLY the same state as it was
  132.      before the file transfer, then you may press "Y".  You should allways
  133.      use "N" if you are not sure.  The most that will happen is that the
  134.      first couple for characters that are received after the file transfer
  135.      will be lost.
  136.  
  137.      Next, you will find a send command and a receive command.  These will
  138.      vary considerably with each protocol, therefore, it is imposible to
  139.      advise you how to configure these lines.  However, the following
  140.      information should allow you to configure almost any external
  141.      protocol.
  142.  
  143.      The following is a list of commands that you may use to configure
  144.      external protocols.
  145.  
  146.      %B   Baud rate              One of: 60, 75, 100, 110, 150, 300, 350,
  147.                                  400, 450, 600, 1200, 2400, 4800, 9600,
  148.                                  19200, 38400.
  149.  
  150.      %C   Communications port    Either 1 or 2.
  151.  
  152.      %D   Data bits              Either 7 or 8
  153.  
  154.      %F   Filename               (default path = none)
  155.  
  156.      %f   Filename               (default path = location of OMEGAEXT.DAT)
  157.  
  158.      %P   Parity (upper case)    One of: O - odd, N - none, E - Even
  159.  
  160.      %p   Parity (lower case)    One of: o - odd, n - none, e - Even
  161.  
  162.      %S   Stop Bits              Either 1 or 2
  163.  
  164.      %X   Download path          Path where OMEGAEXT.DAT was found
  165.  
  166.      %%   The % character        Provided so that this character may be
  167.                                  passed to the external protocol
  168.  
  169.      %$   COMSPEC                environment variable value
  170.                                  (Usally x:\COMMAND.COM where x is the
  171.                                  boot drive)
  172.  
  173.      The following examples assume that your modem is hooked to COM1 and
  174.      is running 8 data bits, no parity, 1 stop bit, 2400 baud, and the
  175.      file OMEGAEXT.DAT is found in C:\OMEGA\FILES.
  176.  
  177.  
  178.  
  179.  
  180.  
  181.      ---------------------------------------------------------------------
  182.      Command: %$/C CISB PORT %C SPEED %B
  183.  
  184.      This will execute COMMAND.COM and pass it the command line:
  185.         /C CISB PORT 1 SPEED 2400
  186.      It should be noted that command.com will do a path search for the
  187.      file CISB.  This may be useful in some cases.
  188.      ---------------------------------------------------------------------
  189.      Command: DSZ COM%C RATE %B SETUP %D-%P-%S %X %F
  190.  
  191.      This will execute the command DSZ.EXE and pass it the command line:
  192.         COM1 RATE 2400 SETUP 8-N-1 C:\OMEGA\FILES\ filename.ext
  193.      where filename.ext is the filename that you enter at the prompt.
  194.  
  195.      ---------------------------------------------------------------------
  196.      Command: C:\OMEGA\PCKERMIT.EXE /c%C /b%B /p%p /t%f
  197.      and you type SMILE.TXT at the filename prompt.
  198.  
  199.      This will execute the command C:\OMEGA\PCKERMIT.EXE with the command
  200.      line:
  201.          /c1 /b2400 /pn /tC:\OMEGA\FILES\SMILE.TXT
  202.      ---------------------------------------------------------------------
  203.      Please note that there are several differences between the sequence
  204.      %X%F and %f.  The first will not allow you to change the default path
  205.      portion, but the second will.  Also, the first will not display the
  206.      default path when you enter the filename, where the second one will
  207.      display the pathname.
  208.      ---------------------------------------------------------------------
  209.      ---------------------------------------------------------------------
  210.  
  211.      After both the send and receive commands there are two switches. The
  212.      first of these is the "Global filenames allowed" switch.  This switch
  213.      disables the check of entered filename, allowing global filenames to
  214.      be passed to the external protocol.  The second switch is "Filename
  215.      required" and is reserved for future use.  Set it to "Y."
  216.  
  217.  
  218.  
  219.      USING AN EXTERNAL PROTOCOL
  220.      --------------------------
  221.  
  222.      To use an external protocol that has been installed, press
  223.      <Ctrl-PgUP> to upload or <Ctrl-PgDn> to download.  Then select
  224.      number 6 (external) from the protocol menu.  The external protocol
  225.      handler will be loaded and you will be presented with a menu of
  226.      protocols.  Select the desired protocol and enter a filename if
  227.      required.  When the file transfer is complete you will be prompted to
  228.      press and key to continue.  As soon as you press a key you will be
  229.      back in Omega-Link.
  230.  
  231.